Skip to content

Add comprehensive multichain testing documentation#1279

Draft
Copilot wants to merge 4 commits intomainfrom
copilot/fix-1273
Draft

Add comprehensive multichain testing documentation#1279
Copilot wants to merge 4 commits intomainfrom
copilot/fix-1273

Conversation

Copy link
Contributor

Copilot AI commented Jul 18, 2025 •
edited
Loading

This PR adds comprehensive documentation for Agoric's multichain testing framework, addressing the need for developers to understand how to test cross-chain applications.

What's Added

📖 New Documentation Page: /multichain-testing

  • What is multichain testing - Comprehensive explanation of testing cross-chain applications
  • Architecture overview - Details about the Starship-powered testing framework
  • Prerequisites - System requirements, software dependencies, and knowledge requirements
  • Resource requirements - Detailed table showing CPU/memory needs for different chains
  • Setup instructions - Step-by-step guide with commands and verification steps
  • Configuration options - Multiple config files for different testing scenarios
  • Test suites - Organized test categories (main, Fast USDC, queries, staking)
  • Example test scenarios - Real TypeScript code examples for common patterns
  • Testing patterns - Asynchronous operations, error handling, state verification
  • Best practices - Test organization, resource management, debugging, performance
  • Troubleshooting - Common issues, debugging tools, and solutions
  • Advanced topics - Custom configurations, relayer options, CI/CD integration

🔧 Navigation Updates

  • Added "Multichain Testing" link in the Build section of the VitePress navigation
  • Positioned after "End-to-End Testing" for logical flow

Key Features

The documentation covers:

  • Multiple blockchain networks (Agoric, Osmosis, Cosmos Hub, Noble)
  • IBC relayer testing (both Hermes and Go relayers)
  • Real test examples with TypeScript code
  • Resource planning with specific CPU/memory requirements
  • Comprehensive troubleshooting guide
  • Integration patterns for CI/CD pipelines

Visual Preview

Multichain Testing Documentation

The documentation provides developers with essential guidance for testing orchestration-based smart contracts that interact with multiple blockchain networks, making it easier to build reliable cross-chain applications on Agoric.

Fixes #1273.

💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.

@cloudflare-workers-and-pages
Copy link

cloudflare-workers-and-pages bot commented Jul 18, 2025 •
edited
Loading

Deploying documentation with  Cloudflare Pages  Cloudflare Pages

Latest commit: ef251a0
Status: ✅  Deploy successful!
Preview URL: https://ff21557a.documentation-7tp.pages.dev
Branch Preview URL: https://copilot-fix-1273.documentation-7tp.pages.dev

View logs

@toliaqat
Complete multichain testing documentation implementation
0ac1922 
Co-authored-by: toliaqat <6778940+toliaqat@users.noreply.github.com>
Copilot AI changed the title [WIP] Multichain-testing is missing from Docs Add comprehensive multichain testing documentation Jul 18, 2025
Copilot AI requested a review from toliaqat July 18, 2025 05:59
@toliaqat toliaqat requested a review from amessbee July 18, 2025 06:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

@toliaqat toliaqat

Copilot code review Copilot

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

Multichain-testing is missing from Docs

3 participants

@toliaqat @Muneeb147